﻿using System;
using System.Collections.Generic;
using System.Text;
using System.Net;
using System.Net.Sockets;

namespace Sofire.DataComm.Net
{
    /// <summary>
    /// 可靠的套接字发送完整数据后发生的事件委托。
    /// </summary>
    /// <param name="sender">事件对象。</param>
    /// <param name="e">事件参数。</param>
    public delegate void SentEventHandler(object sender, SentEventArgs e);

    /// <summary>
    /// 可靠的套接字发送完整数据后发生的事件参数。
    /// </summary>
    public class SentEventArgs : SocketExceptionEventArgs
    {
        private int _SentLength;
        /// <summary>
        /// 获取发送数据的字节长度。
        /// </summary>
        public int SentLength
        {
            get
            {
                return this._SentLength;
            }
        }

        private bool _IsSucceed;
        /// <summary>
        /// 获取一个值，表示发送是否成功。
        /// </summary>
        public bool IsSucceed
        {
            get
            {
                return this._IsSucceed;
            }
        }

        private object _Tag;
        /// <summary>
        /// 设置或获取一个值，表示发送时的自定义数据。
        /// </summary>
        public object Tag
        {
            get
            {
                return this._Tag;
            }
            set
            {
                this._Tag = value;
            }
        }

        /// <summary>
        /// 初始化 <see cref="Sofire.DataComm.Net.SentEventArgs"/> 的新实例。
        /// </summary>
        /// <param name="toSocket">获取接收字节数据的 <see cref="System.Net.Sockets.Socket"/>。</param>
        /// <param name="sentLength">获取发送数据的字节长度。</param>
        /// <param name="tag">用户自定义数据。</param>
        /// <param name="exception">表示发送的异常信息。可以为 null 值，表示这是一个成功的发送结果。</param>
        public SentEventArgs(Socket toSocket, int sentLength, object tag, Exception exception)
            : base(toSocket, exception)
        {
            this._SentLength = sentLength;
            this._IsSucceed = exception == null;
            this._Tag = tag;
        }

    }
}
